home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / pwrlst20.zip / PWRLIST.DOC < prev    next >
Text File  |  1992-09-27  |  11KB  |  240 lines
  1.  
  2.  
  3.  
  4.                ▄▄▄▄▄▄    ▄▄▄▄▄▄   ▄        ▄  ▄▄▄▄▄▄  ▄────▄
  5.                █    ▀▄  ▄█    █▄  █        █  █       █    ▀▄
  6.                █─────▀  █      █  ▀▄  ┌┐  ▄▀  █────   █───▄─▀
  7.                █        ▀█    █▀   ▀▄┌┘└┐▄▀   █       █   ▀▄
  8.                ▀         ▀▀▀▀▀▀     ▀▀  ▀▀    ▀▀▀▀▀▀  ▀    ▀
  9.  
  10.                         ▄        ▄   ▄▄▄▄▄▄  ▄▄▄▄▄▄▄
  11.                         █        █  █▀    ▀     █
  12.                         █        █  ▀─────▄     █
  13.                         █        █  ▄    ▄█     █
  14.                         ▀▀▀▀▀▀▀  ▀  ▀▀▀▀▀▀      ▀
  15.  
  16.  
  17.                               version  2.0
  18.  
  19.                                    by
  20.  
  21.                               Mike Weaver
  22.  
  23.  
  24.                           !!!!! DISCLAIMER !!!!!
  25.  
  26. This program and all other files associated with it are not guaranteed to be
  27. bug free or virus free. Everything possible has been done to insure your
  28. safety and reliability. I, nor my BBS are responsible for any damages of any
  29. kind, including profit loses and data loss, that relate directly or
  30. indirectly to these programs and files.  You may distribute this program, as
  31. long as it is in unmodified form with all the files originally included.
  32.  
  33.                                  OVERVIEW
  34.  
  35. Power List is a utility for PCBoard 14.x, although it has not been tested
  36. on any other systems it should work fine with any system that can produce
  37. a DOOR.SYS or PCBOARD.SYS file.
  38.  
  39. Power List allows the user to design and download a custom built list of
  40. available files on a particular BBS. Hence the name.  Rather than tying up
  41. your system to download a very large complete file listing the user selects
  42. those files areas that interest him/her and then Power List will do the rest.
  43.  
  44. Using PKZip(tm) Power List will compress all the selected file directories
  45. and then using DSZ(tm) it will allow the user to download the list.
  46.  
  47. List of Files in archive:
  48.                          Sample.cfg
  49.                          Pwrlist.doc
  50.                          Pwrlist.exe
  51.                          Pwrlist.
  52.                          File_id.diz
  53.                          NiteLite.txt
  54.                          History.doc
  55.  
  56. SAMPLE.CFG    This is the door configuration file.  The one included in
  57.               this archive is a sample and will have to be edited to fit
  58.               your system.
  59.  
  60. PWRLIST.DOC   Three guesses and the first 2 don't count. <Grin>
  61.  
  62. PWRLIST.EXE   The executable door program itself.  This door is a stand
  63.               alone program that requires no other files such as DoorPatch
  64.               or Brun. I wrote this door using DoorSource 4.0.
  65.  
  66. PWRLIST.      This is a sample batch file to run the door on PCBoard
  67.               systems.  You may have to edit it depending on where you
  68.               store the door files etc.
  69.  
  70. FILE_ID.DIZ   This file contains program descriptions for boards that
  71.               implement automatic file description insertion with a
  72.               program such as PCBDescribe(tm).
  73.  
  74. NITELITE.TXT  This is a small ad for my BBS.
  75.  
  76. HISTORY.DOC   A list of corrections or bug fixes or changes in Power List
  77.  
  78. Configuration file setup:
  79.  
  80.    Line 1 ->            c:\pcb\pcboard.sys
  81.    Line 2 ->            The Nite-Lite bbs
  82.    Line 3 ->            Mike
  83.    Line 4 ->            Weaver
  84.    Line 5 ->            c:\pcb\main\users
  85.    Line 6 ->            1
  86.    Line 7 ->            662345922
  87.    Line 8 ->            c:\pcb\menus\dirs
  88.    Line 9 ->            c:\pcb\gen\           <- trailing backslash a must!
  89.    Line 10->            60
  90.    Line 11->            dos1
  91.          thru           dos2
  92.          whatever       dos3
  93.                         dos4
  94.                         dos5
  95.                         dos6
  96.                         dos7
  97.                         etc.
  98.                         etc.
  99.                         etc.
  100.  
  101. Line 1 ->  Is the location of your pcboard.sys file. The program requires
  102.            the complete path and filename.
  103.  
  104. Line 2 ->  The name of your BBS goes here.
  105.  
  106. Line 3 ->  The SysOp's first name.
  107.  
  108. Line 4 ->  The SysOp's last name.
  109.  
  110. Line 5 ->  The location of your users file.
  111.  
  112. Line 6 ->  This is the com port number you are using.
  113.  
  114. Line 7 ->  This is where you put your serial number once you register the
  115.            program.  Until then use any 9 digit number you like but don't
  116.            leave this line out or the door will crash!
  117.  
  118. Line 8 ->  This is the location of your file directory menu.  The example
  119.            above is from my system, use whatever you use in PCBSetup.
  120.  
  121. Line 9 ->  This is the hard drive directory path to your individual files
  122.            directories.  In other words the directory where the dir files
  123.            are stored.  !! Important !!  The trailing backslash is a must!
  124.  
  125. Line 10->  This number represents the total number of dir files on your
  126.            system.  The unregistered version will handle only 99 dir files.
  127.  
  128. Line 11->  From here to the end of the .cfg file is where you tell the
  129.            program the name of each of your systems dir files.  Using this
  130.            method seemed more versatile to me.  The unregistered version
  131.            is not crippled and will handle as many directories as you
  132.            need to.  However if you use the door Please Register.
  133.  
  134. Command line options:
  135. --------------------
  136.         Power List has numerous command line options in order to provide
  137.         flexibility with most computer systems. Here is a list:
  138.  
  139.                 LOCKED:xxxxx  - Forces Power List to lock the modem at the
  140.                                 speed given.
  141.                 LOCAL         - Forces Power List to run in local mode. This
  142.                                 is really meant for testing purposes, but it
  143.                                 still reads the configuration file, but doesn't
  144.                                 read the bbs interface file.
  145.                 NETWORK       - Forces file sharing to be active incase you
  146.                                 are using something other than SHARE to manage
  147.                                 file locking.
  148.                 IRQ=n         - Lets you change the IRQ used for the com port
  149.                                 specified in the bbs interface file.
  150.                                 (See below for more information)
  151.                 ADDR=&Hnnnn   - Lets you change the address used for the com
  152.                                 port specified in the bbs interface file.
  153.                                 (See below for more information)
  154.                 PS2           - Forces the PS/2 IRQs and addresses if a PS/2
  155.                                 isn't detected (Normally it is, but you can't
  156.                                 always tell!)
  157.                 RBBS          - Forces Power List into RBBS/QBBS mode
  158.                 WILDCAT       - Forces Power List into Wildcat 2.0 mode
  159.                 DOORSYS       - Forces Power List into 31-Line DOOR.SYS mode
  160.                 PCB121        - Forces Power List into PCBoard 11.8/12.x mode
  161.                                 with COM 1 active
  162.                 PCB122        - Forces Power List into PCBoard 11.8/12.x mode
  163.                                 with COM 2 active
  164.                 PCB14         - (DEFAULT) Forces Power List into PCBoard 14.x
  165.                                 mode
  166.  
  167. !!!! I have only run and tested this door with PCBoard 14.5a and I cannot !!!!
  168. !!!! attest to its ability to run on any other systems. Consider yourself !!!!
  169. !!!! warned in advance.                                                   !!!!
  170.  
  171.         When you use the IRQ or the ADDR option, you must include the other.
  172.         You can't use just the IRQ and not the ADDR, and you can't use just
  173.         the ADDR and not the IRQ. Here's a chart with the STANDARD IRQs
  174.         and addresses for the PS/2s and IBM PCs:
  175.                                 Non PS/2
  176.                 Com port       IRQ     Address
  177.                    1             4       &H3F8
  178.                    2             3       &H2F8
  179.                    3             4       &H3E8
  180.                    4             3       &H2E8
  181.                   5-8            4       &H3F8
  182.  
  183.                                 PS/2
  184.                 Com port       IRQ     Address
  185.                    1             4       &H3F8
  186.                    2             3       &H2F8
  187.                    3             3       &H3220
  188.                    4             3       &H3228
  189.                    5             3       &H4220
  190.                    6             3       &H4228
  191.                    7             3       &H5220
  192.                    8             3       &H5228
  193.  
  194.  
  195. Batch file setup:
  196.  
  197.                 d:                     -> Change to the drive where files are.
  198.                 cd\pwrlist             -> Change to PowerList directory
  199.                 pwrlist pwrlist.cfg    -> Run PowerList
  200.                 c:                     -> Change back to BBS drive
  201.                 cd\pcb                 -> Change back to BBS directory
  202.                 board                  -> Reload the BBS
  203.  
  204.  
  205. Function key values:
  206.  
  207.                   F3  - Printer toggle
  208.                   F4  - Page bell toggle
  209.                   F5  - Shell to DOS
  210.                   F7  - Caller alarm toggle
  211.                   F8  - Return caller to board
  212.                   F10 - Start sysop chat
  213.                   ESC - Enter sysop chat
  214.                 ALT-X - Drop to DOS after caller logs off
  215.                 ALT-N - Sysop next on flag
  216.  
  217. One last thing I am terrible at writing so if these docs seem hard to read
  218. or use it is probably because they are. <GRIN>
  219.  
  220. Registration:
  221.         I have not crippled this program in any way, so you can use it
  222.         forever if you like.  However be forewarned that unless you
  223.         register I may not be apt to answer questions as freely.  I
  224.         too however realize the cost of running a BBS so I ask only a
  225.         mere $10 if you like and use the program.  If you do not like
  226.         the program and have an idea that would make it more likeable
  227.         by all means let me know and I will try to implement it.
  228.  
  229.         Bug reports or problems can be left on my bbs at 615-458-9099
  230.         or you can message me through INTELEC in the BBS_DOORS conf.
  231.  
  232.                      OK I'm finished, send the millions to:
  233.  
  234.                                 Mike Weaver
  235.                                 % The NITE-LITE bbs
  236.                                 Rt. 1 Box 231b
  237.                                 159 Macedonia Church Rd.
  238.                                 Philadelphia, Tn.
  239.                                                37846
  240.